home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / frontbuffer.z / frontbuffer
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr((((3333GGGG))))                                                ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr,,,, ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr - enable and disable drawing to the back or front
  10.      buffer
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr((((BBBBoooooooolllleeeeaaaannnn bbbb))))
  14.  
  15.      vvvvooooiiiidddd ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr((((BBBBoooooooolllleeeeaaaannnn bbbb))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _b    is either TRUE or FALSE.
  19.  
  20.           TTTTRRRRUUUUEEEE enables updating in the back/front bitplane buffer.
  21.  
  22.           FFFFAAAALLLLSSSSEEEE disables updating in the back/front bitplane buffer.
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      The GL supports four separate framebuffers:  pop-up, overlay, underlay,
  26.      and normal.  Three of these framebuffers, overlay, underlay, and normal,
  27.      can be configured in double buffer mode.  When so configured, a
  28.      framebuffer includes two color bitplane buffers:  one visible bitplane
  29.      buffer, called the front buffer, and one non-visible bitplane buffer,
  30.      called the back buffer.  The commands sssswwwwaaaappppbbbbuuuuffffffffeeeerrrrssss and mmmmsssswwwwaaaappppbbbbuuuuffffffffeeeerrrrssss
  31.      interchange the front and back buffer assignments.
  32.  
  33.      By default, when a framebuffer is configured in double buffer mode,
  34.      drawing is enabled in the back buffer, and disabled in the front buffer.
  35.      ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr and bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr enable and disable drawing into the front and
  36.      back buffers, allowing the default to be overriden.  It is acceptable to
  37.      enable neither front nor back, either front or back, or both front and
  38.      back simultaneously.  Note, for example, that z-buffer drawing continues
  39.      to update the z-buffer with depth values when neither the front buffer
  40.      nor the back buffer is enabled for drawing.
  41.  
  42.      ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr and bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr state is maintained separately for each of the
  43.      overlay, underlay, and normal framebuffers.  Calls to these routines
  44.      affect the framebuffer that is currently active, based on the current
  45.      drawmode.
  46.  
  47.      bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr is ignored when the currently active framebuffer is in single
  48.      buffer mode.  ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr is also ignored when the currently active
  49.      framebuffer is in single buffer mode, unless zzzzddddrrrraaaawwww is enabled for that
  50.      framebuffer (see zzzzddddrrrraaaawwww).
  51.  
  52.      After each call to ggggccccoooonnnnffffiiiigggg, bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr is enabled and ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr is
  53.      disabled.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      drawmode, doublebuffer, getbuffer, gconfig, singlebuffer, swapbuffers,
  57.      zdraw, rightbuffer, leftbuffer
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr((((3333GGGG))))                                                ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEE
  75.      IRIS-4D G, GT, and GTX models, the Personal Iris, Indigo Entry, Indy, XL,
  76.      XS, XS24, XZ, Elan and Extreme systems do not support double buffer
  77.      operation in the overlay and underlay framebuffers.  IRIS-4D
  78.      RealityEngine model does not support double buffer operation in the
  79.      underlay framebuffer.
  80.  
  81.      At most four color buffers, such as front-left, front-right, back-left,
  82.      back-right, and zdraw, can be rendered into simultaneously on the IRIS-4D
  83.      RealityEngine model.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.